Installation 


Introduction 
To use Dark GDK it will be necessary to obtain Microsoft’s Visual C++ 2008 
and Microsoft’s DirectX 9.0c SDK from August 2007. 


Microsoft's Visual C++ 2008 compiler can be freely downloaded from 
www.microsoft.com/express/vc. For more details on the rest of the Microsoft 
Visual 2008 Express package visit www.microsoft.com/express. 


Microsoft's DirectX 9.0c SDK from August 2007 can be downloaded from 
http://download.microsoft.com/download/3/3/f/33f1af6e-c6 1b-4f14-a0de- 
3e9096ed4b3a/dxsdk_aug2007.exe For more information on this download 
visit http://msdn2.microsoft.com/en-gb/xna/aa937788.aspx. 


For more details on Dark GDK visit: 


e www.microsoft.com/express/samples/gamecreators 
e darkgdk.thegamecreators.com 


More information on other game making products can be found at 
www.thegamecreators.com. 


To keep up to date with all the latest information on Dark GDK sign up to The 
Game Creators newsletter www.thegamecreators.com/?gf=newsletter. 


Installation 
Once you have obtained the required software take the following steps: 


e install Microsoft Visual C++ 2008 
e install Microsoft DirectX 9.0c SDK (August 2007) 
e install Dark GDK 


When this process is complete you will be ready to start using Dark GDK. 


More information on the installation process 
The installer for Dark GDK will perform several checks: 


e it will determine if you have installed Microsoft Visual C++ 2008 

e it will determine if you have installed Microsoft DirectX 9.0c SDK 
August 2007 

e it will ask if you have run Microsoft Visual C++ 2008 at least once so 
the compiler can perform initial set up 


If the installer does not detect Microsoft Visual C++ 2008 then you will be 
asked to install it. lf you select to install the compiler then you will be taken to 
MSDN and provided with a download link. The installer will then quit. After this 
install the compiler and rerun the Dark GDK installer. 


If the installer does not detect Microsoft DirectX 9.0c SDK August 2007 then 
you will be asked to install it. If you select to install the SDK then the installer 
will attempt to download the SDK installer and prompt you to save this. The 
installer will then quit. At this point you may be shown the following dialog: 


("| Program Compatibility Assistant 


This program might not have installed correctly 


If this program didn't install correctly, try reinstalling using settings that 
are compatible with this version of Windows. 


Program: 
ay Publisher: The Game Creators 


Location: C:\Users\Fresh Vista\Docu...\Dark GDK - 121107.exe 


@ Reinstall using recommended settings 


*% This program installed correctly 


@ What settings are applied? 


If this dialog is displayed select the option for “This program installed 
correctly”. When the download for the DirectX SDK has finished install it and 
then rerun the Dark GDK installer. 


Having multiple versions of the DirectX 9.0c SDK installed may cause some 
issues with the installation process. For example, if you have the August 2007 
version installed and then install the November 2007 version the installer will 
not be able to detect the August 2007 version. If this is the case then select 
the option to continue with the installation and then manually set up paths to 
the August 2007 SDK in the compiler after the installation has ended. 


For Dark GDK to integrate into Microsoft Visual C++ 2008 it is necessary that 
you have run the compiler at least once. This will allow the program to 
perform some initial set up. The installer will ask if you have run Microsoft 
Visual C++ 2008 at any point before the installation. If you have then the 
install will continue. If you have not the installer will quit and you can run 
Microsoft Visual C++ 2008, let it perform initial set up, quit out and then rerun 
the Dark GDK installer. 


Windows Vista 

If you are using Windows Vista and try to run Microsoft Visual C++ 2008 with 
a limited user account then you may see the following when working with the 
tutorials and sample projects: 


A Do you want to restart Visual Studio with elevated permissions? 


The solution or project you want to open is located in a directory that Visual Studio does not 
have permission to work in. If you grant Visual Studio permission by using the User Account 
Control feature of your operating system, Visual Studio may be able to complete the 
requested tasks. 


@ Restart Visual Studio under different credentials 
Saves the current changes and then restarts Visual Studio. You will be prompted to 
change your user account. 


> Ignore 
Does not elevate user rights, and continues to run Visual Studio under the current 
user rights. 


If this is the case then change your user account so you have administrator 
access. Selecting ignore at this point will result in being unable to compile: 


= Samples - Visual C++ 2008 Expres 


y Win32 


Build started: Project: 
1>Dark Dungeon : warning PRJO009 = Build log could not be opened for writing. 
1>Make sure that the file is not open by another process and is not write-protected. 
1>Dark Dungeon : error PRJO0O07 : Could not create output directory ‘c:\Program Files\The Game Creators\Dar} 
1>Dark Dungeon : error PRJOO0€ - Could not open the temporary file ‘c:\Program Files\The Game Creators\Dar} 
1>Compiling..- 
1>Project : error PRJOO03 : Error spawning '/O02'. 


1>Build log was saved at "f£ile://c ogrem 
1>Dark Dungeon - 3 error(s), 1 warning(s) 
SS Build: O succeeded, 1 failed, 0 up-to-date, 0 skipped 
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Si Code Definition Window [5] Output 
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Starting a new project 
Launch Microsoft Visual C++ 2008, go to the File menu and select New 
Project 


File | Edit View Tools Window Help 


bent 
Q| File... Ctrl 
Project From Existing Code... 


ted Items As... 


Save All Ctrl+Shift+5. 


Page Setup... 
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Print... Ctrl+-P 
Recent Files > 
Recent Projects > 


Exit 


‘Soluti... Class... |[-dPrope... 


Show o1 From: y sr) | 


Code Definition Window | #E)Call Browser | =) Output 5] Find Results 1 


Ready 


You will now be presented with a new dialog. Select the Wizards item on the 
left and on the right side you will be shown a list of Dark GDK templates 


rc 


New Project 


Project types: Templates: 


=) Visual C++ | ¥isual Studio installed templates 
CLR 
Wwin32 Py Dark GDK - 2D Game @y Dark GDK - 3D Game 
General QyDark GDK - Game 
Wizards 
My Templates 


(Search Online Templates... 


TODO; Wizard Description. 


Name: Dark GDK - Game2 


Location: C:\Documents and Settings\Mike Johnson\My Documents\¥isual Studio 2008\Projects y| 


Solution Name: Dark GDK - Game2 Create directory For solution 


Each of these templates offers you a simple starting point for a Dark GDK 
game. The 2D game template contains basic code to display some sprites on 
screen. The 3D game template contains code demonstrating how to create 
3D objects and move the camera. Finally the game template contains the 
minimum code required for a Dark GDK game. 


When you have decided which template to base your project off give ita 
name and location for saving to and then press the ok button. 


In this example the game template has been used and it has provided us with 
one source file named Main.cpp 


“| Dark GDK - Game? - Visual C++ 2008 Express Edition 
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File Edit View Project Build Debug Tools Window Help 


$i fF ed | Ga 


||| (Global Scope) 


| >» Debug 


Main.cpp | 


il @ DarkGDKQ) 


[eq] Solution ‘Dark GDK - Game2' (1 proje |) 
= [ Dark GDK - Game2 | 
= Source Files | 
C+) Main.cpp 
() Readme.txt 


>|) 


m 
how fBzCSS oe [egerope. | | 


Gi// Dark GDK - The Game Creators - www.thegamecreators.com 


// the wizard has created a very simple project that uses Dark GDK 
// it contains the basic code for a GDK application 


// whenever using Dark GDK you must ensure you include the header file 
#include "DarkGDK.h” 


-// the main entry point for the application is this function 


Givoid DarkGDK ( void } 


{ 
// turn on sync rate and set maximum rate to 60 fps 
dbSyncOn { j: 
dbSyncRate { 60 j}; 


// our main loop 

while ( LoopGDK { }) } 

{ 
// update the screen 
dbSync ( }; 

} 


// return back to windows 


‘Show output from: 


GapCode Definition Window |EiCall Browser | =] Output (EJ Find Results 1] 


Ready 


From this point onwards you have everything you need to start using Dark 


GDK. 


Compiler Errors 

Dark GDK will attempt to automatically integrate into Microsoft Visual C++ 
2008. However, in the event this does not happen you will encounter some 
compiler errors such as 


Fatal error C1083: Cannot open include file: ‘DarkGDK.h’: No such file 


Fatal error C1083: Cannot open include file: ‘d3dx9.h’: No such file or 


e 

or directory 
e 

directory 
e 


Fatal error LNK1104: Cannot open file: ‘darksdk.lib’ 


e Fatal error LNK1104: Cannot open file: ‘d3dx9.lib’ 


If you get any errors such as those listed then it will be necessary to manually 
setup the compiler. 


Launch Microsoft Visual C++ 2008. Select the Tools menu and then Options. 


File Edit view | Tools | window Help 
q x Attach to Process... Ctrl+alt-+P 


Connect to Database... 


Code Snippets Manager... Ctrl+K, Ctrl+B 


Choose Toolbox Items... 


ILDasm 
Visual Studio 2008 Command Prompt 
External Tools... 


Import and Export Settings... 


Customize... 


When the options dialog is displayed look at the list on the left. Select Projects 
and Solutions and then VC++ Directories. 


4) Environment Show directories for: 
=) Projects and Solutions ha Executable files 


wleil x) +/+! 


General 


VC++ Project Settings se Waaraesmest elm 

(8. Text Editor $(\¥SInstallDir}Common?\Tools\bin 

(4) Database Tools $(VSInstallDir}Common?\tools 

(4). Debugging $(¥SInstallDir}Common? tide 
$(ProgramFiles}\HTML Help Workshop 
$(FrameworkSDKDir bin 
$(FrameworkDir$(FrameworkVersion) 
$(¥SInstallDir} 
$(SystemRoot)\SyswWow6b4 


AF ee 


\< | mm 


4) Windows Forms Designer 


Executable Directories 
Path to use when searching for executable files while building a ¥C++ 
project. Corresponds to environment variable PATH. 


Now look on the right side of this dialog and select the drop down list named 
Show directories for and then click on Include files. 


)- Environment Platform: Show directories for: 


=) Projects and Solutions Win32 iy] “Include files v| 


General 


Build and Run | [=i xi +{ 4] 


eras $(V¥CInstallDir include 
4 were PURER Ses $(¥CInstallDir atimFc\include 
® Text Editor $(\WindowsSdkDir}\include 
AP 


4) Database Tools 
4) Debugging 
4) Windows Forms Designer 
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Include Directories 
Path to use when searching for include Files while building a ¥C++ project. 
Corresponds to environment variable INCLUDE. 


We can now modify this and inform the compiler where the Dark GDK header 
files are stored. To do this double click on the line at the bottom and then 
select the button with three dots. 


)- Environment Platform: Show directories for: 
©) Projects and Solutions | wing2 iy] Include files vy] 
General 


Build and Run v{ee x| +i 4) 


VC++ Directories 
$(V¥CInstallDir include 


i vere Project Settings $(V¥CInstallDir atlmFc\include 
(8. Text Editor $(WindowsSdkDir)\include 
(+) Database Tools $(FrameworkSDKDir include 
) Debugging 


4) Windows Forms Designer 


Include Directories 
Path to use when searching for include Files while building a ¥C++ project. 
Corresponds to environment variable INCLUDE. 


You will now be presented with a dialog asking you to select a directory. 
Navigate to the folder where Dark GDK is installed and select the Include 
folder and then press the OK button. The default path for the include file will 
be c:\program files\the game creators\dark gdk\include. 


Select Directory x) 


=) |) The Game Creators * 
# |) Dark Basic 
® |) Dark Basic Professional and Dark Phy: 
4) |) Dark Basic Professional Online 
|) Dark Basic Professional Trial 
= (©) Dark GDK 

(©) Documentation 

© Include 
(9 DBO Format 

© Lib 

(5 Media 

(©) Samples 

(9 Tools 

( Tutorials 

4 | Wizards 


IPA Dark Shader 
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Folder; ‘Include 


Make New Folder 


A link to this directory will get added into the compiler include file listing. 


(4) Environment 

=) Projects and Solutions 
General 
Build and Run 
VC++ Directories 
V¥C++ Project Settings 

) Text Editor 

(4) Database Tools 

4) Debugging 

4) Windows Forms Designer 


Platform: 


Show directories for: 


“win32 


Include files vy] 


$(V¥CInstallDir include 
$(V¥CInstallDir atlmFc\include 
$(WindowsSdkDir include 
$(FrameworkSDKDirjinclude 
C:\Proar 


\¢ ] rm 


e Game CreatorsiDark GDK\Incude 


whet x| +] | 


Ill 


ca 


(2) 


[Include Directories 


Path to use when searching for include Files while building a ¥C++ project. 
Corresponds to environment variable INCLUDE. 


(x) Gene 


At this point we have added a reference in the include listings for Dark GDK. It 
is also necessary to ensure the compiler can reference include files for the 
DirectX 9.0c SDK from August 2007. Repeat the procedure and add a new 


include listing. 


Options 


(4) Environment 

(=) Projects and Solutions 
General 
Build and Run 
VC++ Directories 
VC++ Project Settings 

) Text Editor 

(4). Database Tools 

) Debugging 

+) Windows Forms Designer 


Platform: 


Show directories for: 


Win32 vy) 


Include files 'y| 


$(V¥CInstallDirjinclude 
$(V¥CInstallDiratlmFc\include 
$(\WindowsSdkDir include 
aa atl ed Se 


\< | Mm 


Include Directories 


Path to use when searching For include Files while building a ¥C++ project. 
 Sorespone to environment variable INCLUDE. 


a) Gene 


The same process must now be completed for the library files. Look on the 


right side of this dialog and select the drop down list named Show directories 
for and then click on Library files. 


Options 


&)- Environment Platform: Show directories For: 

(=) Projects and Solutions Win32 y] ‘Library Files 'y] 
General : 
Build and Run v | | x| +|+| 
¥C++ Directories 

: : $(¥CInstallDirjlib 

| De ed $(vCInstallDir)atlmfc\lib 

(#) Text Editor $(¥CInstallDirjatlmfc\lib\i386 

(+) Database Tools $(WindowsSdkDir Wb 

#4) Debugging $(FrameworkSDKDirjlib 


) Windows Forms Designer 


$(VSInstallDir) 
Fi 
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Library Directories 
Path to use when searching for library files while building a ¥C++ project. 
Corresponds to environment variable LIB. 


Add in links to the library files that come with Dark GDK and DirectX 9 SDK. 
The default path for the library files that come with Dark GDK is c:\program 
files\the game creators\dark gdk\lib\vs9. The default path for the library files 
that come with DirectX 9 SDK is c:\program files\microsoft directx sdk (august 
2007)\lib\x86. 


Options x 
Environment Platform: Show directories For: 
=) Projects and Solutions Win32 vy) | Library Files vy) 
General 


Build and Run vile x| +| + 


VC++ Directories 
$(V¥CInstallDirjlib 


aa de aa taal $(¥CInstallDir }atlmfc\lib 

(H- Text Editor $(¥CInstallDirjatlmFc\lib\i386 

(+) Database Tools $(WindowsSdkDir Wb 

(Debugging $(FrameworkSDKDirjlib ~ 


$(¥SInstallDir} 

$(¥SInstallDirjlib 

C:\Program Files\The Game Creators\Dark GDK\Liby\y¥S9 
C:\Program Files\Microsoft DirectX SDK (August 2007)\Lib\x86 


4) Windows Forms Designer 


i< | im 

Library Directories 
Path to use when searching for library files while building a ¥C++ project. 
Corresponds to environment variable LIB. 


Once links have been added into the compiler for Dark GDK and DirectX SDK 
include and library files then the process is complete and you should be able 
to compile without any errors. 


